home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Utilities / Help / locale / help / english / sys / newshell.doc < prev    next >
Encoding:
Text File  |  2000-10-06  |  4.8 KB  |  174 lines
  1. NEWSHELL
  2.  
  3. Opens a new Shell window.
  4.  
  5. Format
  6.  
  7. NEWSHELL [<window specification>] [FROM <filename>]
  8.  
  9. Template
  10.  
  11. WINDOW,FROM
  12.  
  13. Location
  14.  
  15. Internal
  16.  
  17. The new Shell window becomes the currently-selected window and process. The
  18. new window has the same current directory, prompt string, path, local
  19. environment variables, and stack size as the one from which it is invoked.
  20. However, each Shell window is independent, allowing separate input, output,
  21. and program execution.
  22.  
  23. The window can be sized, dragged, zoomed, and depth-adjusted like most other
  24. Amiga windows.
  25.  
  26. To create a custom window, you can include the <window specification>
  27. argument. Specify the initial dimensions, location, and title of the window
  28. with this <window specification> syntax:
  29.  
  30. CON:x/y/width/height/title/options
  31.  
  32. where:
  33.  
  34. x
  35.  
  36. Is the number of pixels from the left edge of the screen to the left border
  37. of the Shell window. Use a value (//) to specify the minimum possible pixels.
  38.  
  39. y
  40.  
  41. Is the number of pixels from the top of the screen to the top of the Shell
  42. window. Use no value (//) to specify the minimum possible pixels.
  43.  
  44. width
  45.  
  46. Is the width of the Shell window, in pixels. Use no value (//) to specify the
  47. full width of the screen.
  48.  
  49. height
  50.  
  51. Is the height of the Shell window, in pixels. Use no value (//) to specify
  52. minimum possible height.
  53.  
  54. title
  55.  
  56. Is the text that appears in the Shell window title bar.
  57.  
  58. Use slashes to separate the parameters and options. If any spaces appear in
  59. the specification argument, the entire argument must be enclosed in double
  60. quotation marks (").
  61.  
  62. The allowable options are:
  63.  
  64. AUTO
  65.  
  66. The window automatically appears when the program needs input or produces
  67. output. With the Shell window, it opens for input immediately. The window can
  68. only be closed with the ENDSHELL command. Selecting the Shell's close gadget
  69. closes the window, but it re-opens immediately since it is expecting input.
  70.  
  71. ALT
  72.  
  73. The window appears in the specified size and position when the zoom gadget is
  74. clicked. The four parameters must be separated with slashes (for example,
  75. ALT30/30/200/200).
  76.  
  77. BACKDROP
  78.  
  79. The window appears on the backdrop, behind all the Workbench windows. This
  80. Shell window cannot be brought to the front of the screen; you have to resize
  81. the Workbench windows to see it.
  82.  
  83. CLOSE
  84.  
  85. The window has all the standard gadgets, including a close gadget. This is
  86. the default for Shell windows, but you must specify it to get a standard
  87. Shell if you use the WINDOW argument.
  88.  
  89. INACTIVE
  90.  
  91. The window opens, but is not made the active window.
  92.  
  93. NOBORDER
  94.  
  95. The window opens without any left or bottom window border. Only the zoom,
  96. depth, and sizing gadgets are available.
  97.  
  98. NOCLOSE
  99.  
  100. The window does not have a close gadget. If you open a console normally,
  101. there is no close gadget. If you open a console using the AUTO option, there
  102. is automatically a close gadget on the window.
  103.  
  104. NODEPTH
  105.  
  106. The window has no window depth gadget.
  107.  
  108. NODRAG
  109.  
  110. The window cannot be dragged. It has zoom, depth and sizing gadgets, but no
  111. close gadget.
  112.  
  113. NOSIZE
  114.  
  115. The window only has a depth gadget.
  116.  
  117. SCREEN
  118.  
  119. The window opens on a public screen. The screen must already exist. You must
  120. specify the name of the screen after the SCREEN keyword.
  121.  
  122. SIMPLE
  123.  
  124. If you enlarge the window, the text expands to fill the newly available
  125. space, allowing you to see text that had been scrolled out of the window.
  126. This is the default for standard Shells.
  127.  
  128. SMART
  129.  
  130. If you enlarge the window, the text does not expand to fill the newly
  131. available space. This saves memory.
  132.  
  133. WAIT
  134.  
  135. The window can only be closed by selecting the close gadget or entering
  136. Ctrl+\. If WAIT is the only option, there is no close gadget.
  137.  
  138. NEWSHELL uses the default startup file S:Shell-startup, unless a FROM file
  139. name is specified. S:Shell-startup is a standard AmigaDOS script file. For
  140. example, you can have several different Shell-startup files, each having
  141. different command aliases. You can call such customized Shell environments
  142. with FROM.
  143.  
  144. The NEWCLI command has the same effect as NEWSHELL; it invokes a new Shell
  145. process.
  146.  
  147. Example 1:
  148.  
  149. 1> NEWSHELL
  150.  
  151. opens a new Shell window with the default window specification.
  152.  
  153. Example 2:
  154.  
  155. 1> NEWSHELL "CON://640/200/My Shell/CLOSE"
  156.  
  157. A window starting in the upper left corner of the screen and measuring 640
  158. pixels wide and 200 pixels high opens. The window is titled My Shell and it
  159. has a close gadget. The entire argument is enclosed in quotation marks
  160. because the title contains a space. If you add the command to your
  161. User-startup file, a Shell window opens automatically when your Amiga is
  162. booted.
  163.  
  164. Example 3:
  165.  
  166. 1> NEWSHELL FROM S:Programming.startup
  167.  
  168. opens a new Shell, but instead of executing the Shell-startup file, the
  169. Programming.startup file is executed. You can have aliases and prompt
  170. commands in the Programming.startup file that are used only when you are
  171. programming.
  172.  
  173. For more examples using NEWSHELL, see Chapter 8.
  174.